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SECTION 1 
INTRODUCTION 


The purpose of this manual is to provide explicit directions 
for the software installation of a VORTEX or VORTEX II 
operating system and the accompanying software. Reference 
manuals for the software provide adequate technical information 
to perform these procedures, and this manual supplements that 
information with step-by-step procedures and special data. 


For more efficient use of this manual, the thorough reading 
and understanding of the reference manuals provides the best 
background. In fact, the pertinent reference manuals are 
useful to have available while following the procedures 
described here. 


This manual supplements the following manuals: 


VORTEX Reference Manual 98 A 9952 10x 
VORTEX II Reference Manual 98 A 9952 24x 
VTAM Reference Manual 98 A 9952 22x 
HASP/RJE Operator's Manual 98 A 9952 21x 


where x represents the current revision of the 
manual, 


Section 1.2 gives the current documentation levels with 
this revision of the Installation Manual. 


This manual offers greater support than the reference 
manuals to the user for specific systems configuration. 
In this manual, some of the variations possible with 

the VORTEX and VORTEX II operating systems are presented 
for the first time. 


This publication is more dynamic and likely to be revised 
more frequently than the reference manuals. This represents 
continuing software development and increasing needs in 
support. These revisions will include replacements and 
additional pages. This manual corresponds with the release 
level of software given on the back of the title page. 


1-1 


varian data machines @ 


1.1 REFERENCES IN THIS MANUAL 


Here references to other Varian Data Machines software manuals 
are indicated in parentheses. In the parentheses, the short 
form of a title of a manual is followed by the section, table 
or figure number referenced. For example, (VORTEX, 3.4) 

refers to section 3.4 of the VORTEX Reference Manual, and 
(VORTEX II, figure 13-2) refers to figure number 13-2 (consult 
the list of illustrations for the page number on which figures 
appear). When a reference is the same in both the VORTEX and 
VORTEX II Reference Manuals, it is given as (VORTEX, VORTEX II, 
13. 2) e 


Reference 

in Text Manual 

VORTEX V70/620 VORTEX Reference Manual 

VORTEX II V70 VORTEX II Reference Manual 

VTAM V70 VTAM Reference Manual 

HASP/RJE V70 HASP/RJE Operator's Manual 

without V70/620 VORTEX Installation Manual. 

title 

Reference Meaning 

Table n-n Table in manual mentioned 

Figure n-n Figure in manual mentioned 

Section n Entire section is pertinent 

Hen or Subsection within manual mentioned 
nen 


Numbers: A number with a leading zero is octal, one without 
a leading zero is decimal, and a number in binary is 
specifically indicated as such. 


1.2 SUPPORTING DOCUMENTATION 
These manuals and Software Performance Specifications (SPSs) 


are the ones available at the time of the publication of this 
manual. 
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VORTEX Reference Manual plus Addenda 1 and 2 
(98 A 9952 102) 


VORTEX: 


VORTEX External 
(89A0203 E) 


VORTEX Internals 
(89A0231 C, 89A0232 C, 89A0233 D, 89A0304 A) 


VORTEX IT: 


VORTEX II Reference Manual plus Addendum 1 
(98 A 9952 241) 


VORTEX II External 
(89A0273 A) 


VORTEX II Internal Supplement 
(89A0289 A) 

Related Customer Acceptance Test Programs: 
VORTEX, 92 (J,G,R,S,U,W)1605-011G 
VORTEX II, 92 (J,R.G,S,U,W)1605-010G 


varian data machines @ 


SECTION 2 
MEMORY CONFIGURATION 


This section describes procedures for calculating the central 
memory requirements for VORTEX and VORTEX II systems. 

Section 2.1 gives tables and procedures. for VORTEX systems. 
Section 2.2 gives similar tables and procedures for VORTEX 

II systems. Care should be taken not to confuse the VORTEX 
and VORTEX II requirements. 


The specific memory requirements given here are for a 
particular release of the VORTEX/VORTEX II system. The 
numbers are subject to change from release to release. 

The release level for these numbers is given on the second 


page. 


Before calculating the memory requirements, the user should 
know the following information: 


a. peripherals -- number of each type and their 
model numbers 


b. VTAM and HASP/RJE use for data communications 
C. VORTEX foreground and background tasks to be run 


d. Sizes of application tasks to run as foreground 
tasks concurrently 


e. Size of the largest background task to run with 
concurrent foreground tasks determined in the 
preceding step. 


The minimum hardware configuration as well as optional 
enhancements for VORTEX are defined in the reference 
manuals (VORTEX, VORTEX II, 1.1). Optional hardware 
supported by VORTEX and VORTEX II is described in an 
appendix in the reference manuals (VORTEX, VORTEX II 
Appendix F). ; 
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Memory considerations for the basic system and some options 
are defined in this manual in sections 2.1 and 2.2. For 
data pertinent to optional hardware, see section 3.2 of this 
manual, 


2.1 VORTEX MEMORY REQUIREMENTS 


This section describes the procedure to determine the central 
memory requirements for various parts of the VORTEX 

operating system. By selecting values from these tables in 
the manner described in this selection, the central memory 
requirements needed for different configurations and tasks 
are calculated. 


Memory is specified here in words and multiples of words. 
Following the designation of an amount of memory, K means 
1024 words, e.g., 2.5K would be 2560 words and 64K is 
65,556 words. | 


To determine the VORTEX nucleus size, select entries from 
Tables 2-1 through 2-6 and enter the results into the 
worksheet (figure 2-1) in the following manner: 


a. Select driver and controller table sizes from 
tables 2-1 through 2-4, Each type of device requires 
only one driver, even though there may be more than 
one of the same device in the system. However, for 
each master device there is one controller. Thus, 
if a system has two master teletypes, it needs one 
TTY driver and two controller tables. Slave units 
do not require a controller, so if a system has one 
master disc with one slave disc, it needs one 
appropriate disc driver and a single controller table. 


b. Select the executive components size from table 
2-6. 


on Select other tables and low memory linkage from 
table 2-5. A minimum system consists of three 
devices, one PIM, eight partitions, one empty TIDB, 
no foreground common and no retry stack. . 


d. Add the results of steps a, b, and c for the total 
size of the VORTEX nucleus, 


e, For VTAM systems, add the central memory requirements 
in table 2-7. 
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£ Add central memory requirements for the various 
foreground and background tasks from table 2-8. 
These requirements are necessary only if the 
requested programs are loaded and active at the 
same time, Central memory requirements for fore- 
ground are cumulative, i.e., if three foreground 
programs are to be loaded and active, then the 
central memory required is the sum of the program's 
individual central memory requirements. The 
central memory requirements for background are not 
cumulative, because only one background task can be 
resident at one time. 


Note: JCP must be resident to load any background program 
and is overlayed during the loading. 2.5K for JCP is the 
minimum background, if any background is used. 


The OPCOM overlay (.5K) will always be resident. | 
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Memory Required 


Controller 
Table 


Function 


Table 
Driver Controller Subtotal Total 
“ ae ae oe 


(70-6104) 
CRT (E2250) 


Keyboard Devices 
(one or more 
needed) 


RMDs 
(one or more 
needed) 


DOA (70-770x) 
DOB (70-7600, 

-7610) 
DOC (70-7500) 
(70-7510) 


High-Speed 
Input Devices 
(one or more, 
or 2 RMDs) 


MT (70-7100, 
-7102, 
-7103) 

CR (70-6200) 

PT (70-6320) 


Optional 
Devices 


LPOA (70-6701) 

cP (70-7601) 

LPOD (70-6602, 

-6608) 

LPOE (70-6602/ 
-6608 with 
31-152) 

LPOG (70-6602/ 
-6608 with 
31-142 § 152 

LPOH (70-6641/ 
-6642 with 
31-152 

LPOJ (70-6611, 
-6613, -6615 

-6617, -6621 

-6623, -6625 

-6627) 


VORTEX 
Tables and 
Low Memory Area 


Minimum System 


Additional I/O Tables 12/extra device 
Devices (in TIDBs (empty) 25/TIDB 
addition to PIM 40/extra PIM 
minimum PST 3/extra partition 
system) Foreground Varies 

Common 


Retry Stack Varies 


Executive 


System Tasks (I/0 
Components 


Control, RTE) 
SPOOL subsystem 
WCS 
Process Input 
Process Output 
Reentrant FORTRAN 


3758 


1333 + 349/stream 
71 

283 + 16/controller 

146 + 25/controller 

3266 


VORTEX/VTAM CCM Components 3275 


System Line Tables 17/line 
(Only VTAM DCM Multiplexor 512 

systems need TCM Components 2600 

this memory) Terminal Tables 17/terminal 


Nucleus Total 


Ee) SOUIYORW e}eP UBLIEA 
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Table 2-8. 


Table 2-8. 


Function 


Foreground Tasks 


Memory required 
is the sum of 
all FL tasks 
resident at one 
time. 


Background Tasks 


Only one BL 
task may be 
resident at 
one time. 


VTT1-2154 


Program 


JPDUMP 
RAZI 
OPCOM 
MIUTIL 


VTAM overlays 


WCSRLD 
HASP/RJE 


JCP 
DASMR 
FORTRAN 
RPGC 
RPGRT 
LMGEN 
FMAIN 
SMAIN 
CONC 
IOUTIL 
SEDIT 
MICSIM 
MIDAS 

NDM (VTAM) 
VSORT 
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VORTEX Memory Requirements for Library Routines 


VORTEX Memory Requirements for Library Routines 


Memory 
Required 


2.5K 

8.5K+symbol table 
10,.0K+symbol table 
6.5K+symbol table 
6.5K+symbol table 
7.5K 

8K 

7.5K 

7.5K 

4K 

8.5K 

9K - 

8.0K 

8.5K 

4.0K 


+ Nucleus 


Total Memory 
Required 


{ 
d 
i 
! 
1 


4 


Calculation 


Total 
Foreground 


+ Required 
Background 


is used: 


a. Calculate the size of the nucleus which is always 
resident. 


b. Calculate the largest total required foreground 
central memory for the foreground programs which 
must be resident at a given time. Table 2-8 
gives memory sizes for library routines. 


Cc. Calculate the total required background memory, 
central memory for the largest background program 
which must be or is desired to be resident while 
the foreground programs from step b are resident, 


d, Add the results from steps a, b, and c for the 
minimum memory required. on 


Note: With this limit from step d, larger programs can be 
loaded and executed if some of the foreground programs from 
step b are not loaded and active. 


VORTEX Configuration Examples: Calculate the memory required 
for the nucleus of a minimum VORTEX system. A minimum system 
must consist of a console device, an RMD, and a high-speed 
input device. Also, it must use memory equal to the minimum 
values from tables 2-5 and 2-6. For this example, let the 
system consist of the following: 

a. TTY 

b. RMD model number 70-770x 

Cc. Card Reader 

d. PIM 

The actual calculation is as follows: 


a. From table 2-1, one TTY driver and one controller 
table. 


b. From table 2-2, one RMD driver (70-770x) and one 
controller table. 
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To calculate the total memory required, the following procedure 
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From table 2-3, one card reader driver and one 
controller table. 


From table 2-4, no optional devices 
From table 2-5, no additional devices, and use minimum 
From table 2-6, use precalculated total, for system 


tasks, without process I/0, reentrant FORTRAN, 
wWCS or SPOOL. 


Figure 2-2 shows the calculation, 


The nucleus size is 7152 words, the total from the above. 
Dividing the total by 1024 gives the memory requirement in 
units of K words. Table 2-8 may be used to determine if 
sufficient memory remains for various library tasks. 


For this system with 7.0K nucleus with the required foreground 
consisting of OPCOM (.5K), an application program (1.0K), and 
running the FORTRAN compiler with a minimum symbol table (10.0K), 
the required memory would be 18.5K if the compiler is to be run 
while the application program is running, or 17.5K if the compiler 
is to be run only when the application program is not running. 


Figure 2-3 shows memory calculation for running the application 
program and the FORTRAN compiler at different times. 
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Keyboard Devices 
(one or more 
needed) 


RMDs 
(one or more 
needed) 


High-Speed 
Input Devices 
(one or more, 
or 2 RMDs) 


Optional 
Devices 


VORTEX 
Tables and 
Low Memory Area 


Additional 
Devices (in 
addition to 
minimum 
system) 


Executive 
Components 


VORTEX/VTAM 
System 
(Only VTAM 
systems need 
this memory) 


(70-6104) 
(E2250) 


(70-770x) 
(70-7600, 

-7610) 
(70-7500) 
(70-7510) 


MT (70-7100, 
-7102, 
-7103) 

CR (70-6200) 

PT (70-6320) 


LPOA (70-6701) 
CP (70-7601) 
LPOD (70-6602, 

-6608) 

LPOE (70-6602/ 
-6608 with 
31-152) 

LPOG (70-6602/ 
-6608 with 
31-142 § 152 

LPOH (70-6641/ 
-6642 with 
31-152 

LPOJ (70-6611, 
-6613, -6615 
-6617, -6621 
-6623, -6625 
-6627) 


Minimum System 


I/O Tables 
TIDBs (empty) 
PIM 

PST 
Foreground 
Common 
Retry Stack 


System Tasks (1/0 
Control, RTE) 
SPOOL subsystem 

WCS 

Process Input 
Process Output 
Reentrant FORTRAN 


CCM Components 
Line Tables 

DCM Multiplexor 
TCM Components 
Terminal Tables 


Memory Required 


Controller 


Driver 


12/extra device 
2S5/TIDB 

40/extra PIM 
3/extra partition 

Varies 


Varies 


+ 349/stream 


+ 16/controller 
+ 25/controller 


3275 
17/line 
512 
2600 
17/terminal 


Driver 


oe le | 


86 


- | 
pw | ce 


Nucleus Total 
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Memory 
Function Program Required Calculation 
Foreground Tasks JPDUMP . OK 
RAZI 6.5K 
Memory required © OPCOM . OK 
is the sum of MIUTIL 3.0K 
all FL tasks VTAM overlays 1.5K 
resident at one WCSRLD 5K 
time. HASP/RJE 8.0K Total 
Foreground 
o: 
Background Tasks JCP 2.5K 
DASMR 8.5K+symbol table 
Only one BL FORTRAN 10.0K+symbol table 
task may be RPGC 6.5K+symbol table 
resident at RPGRT 6.5K+symbol table 
one time, LMGEN 7.5K 
FMAIN 8K 
SMAIN Pe 
CONC 7eoK 
IOUTIL 4.0K 
SEDIT 8.5K 
MICSIM 9K - 15K 
MIDAS 8.0K 
NDM (VTAM) 8.5K 
VSORT 4.0K 
+ Required 
| Background 
10.0 
+ Nucleus 7.0 


Total Memory 
Required 17.5K 


VTI1-3008 


Figure 2-3. Sample VORTEX Memory Requirements for 
Library Routines 
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The total nucleus size determined from the steps above is 
added to the library requirements to determine the total 
memory requirements. 
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VORTEX EXAMPLE 2 


Calculate the central memory required for the nucleus of 
a VORTEX system containing the following: 


(one each unless specified otherwise) 


TTY 

CRT 

RMD model number (70-7500) with ten partitions 
RMD (70-7610) with ten partitions 

Two magnetic tape devices (both master units) 
Card reader 

Paper-tape unit 

Card punch 

Line printer (70-6701) 

Two PIMs 

Process I/0 

Reentrant FORTRAN 

Six empty TIDBs 

0200-word common area 

100-word retry stack 


The calculation, shown in figure 2-3, for this sample 
system is as follows: 


From table 2-1, one TTY/CRT driver, one controller 
table for TTY and one for CRT 


From table 2-2, one 70-7500 driver and its controller 
table, and one 70-7610 driver and its controller 
table 


From table 2-3, one magnetic-tape driver and two 
controller tables, one card reader driver and its 
controller table, and one paper-tape driver and 
its controller table. 


From table 2-4, one line printer driver and its 
controller table and one card punch and its 
controller table 


From table 2-5, add 
7 additional I/O tables 
13 additional empty TIDBs (6 empty and 
7 for devices) 
1 additional PIM 
12 additional PSTs 
Foreground common 
Retry stack 


From table 2-6, use the total for system tasks plus 
the values for process I/O and reentrant FORTRAN, 
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Memory Required 


Controller 
Driver 


Table 


TTY (70-6104) 


Table 
Sears 
ial Le Ll ae 


474 162. 1136 
(234 170 1404 2570 
S3i 3G 567 
408 43 
483 20 

4 
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Keyboard Devices 
(one or more 


or 
needed) CRT (E2250) 


RMDs 
(one or more 
needed) 


DOA (70-770x) 
DOB (70-7600, 

-7610) 
DOC (70-7500) 
DOD (70-7510) 


High-Speed MT (70-7100, 


Input Devices -7102, 
(one or more, -7103) 
or 2 RMDs) CR (70-6200) 

PT (70-6320) 


Optional 
Devices 


LPOA (70-6701) 
CP (70-7601) 
LPOD (70-6602, 

- 6608) 

LPOE (70-6602/ 
-6608 with 
31-152) 

LPOG (70-6602/ 
-6608 with 
31-142 § 152 

LPOH (70-6641/ 
-6642 with 
31-152 

LPOJ (70-6611, 
-6613, -6615 
-6617, -6621 
-6623, -6625 

-6627) 


VORTEX 
Tables and 
Low Memory Area 


Minimum System 


Additional 
Devices (in 
addition to 


1/0 Tables 
TIDBs (empty) 
PIM 


12/extra device 
25/TIDB 
40/extra PIM 


minimun PST 3/extra partition 
system) Foreground Varies 
Common 


Retry Stack Varies 


Executive 3758 


Components 


System Tasks (1/0 
Control, RTE) 
SPOOL subsystem 

WCS 

Process Input 

Process Output 

Reentrant FORTRAN 


1333 + 349/stream 
71 


283 + 16/controller 
146 + 25/controller 
3266 


VORTEX/VTAM CCM Components 3275 
System Line Tables 17/line 
(Only VTAM DCM Multiplexor $12 
systems need TCM Components 2600 
this memory) Terminal Tables 17/terminal 


Nucleus Total 


SOUIUDeU! B}ep URLIBA 
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2.2 VWORTEX IT MEMORY REOUIREMENTS 


a. 


This section describes the procedures to determine the central 
memory requirements for various parts of the VORTFX If 
operating system, Bv selecting values from the following 
tables in the manner described in this section, the central 
memory requirements needed for different configurations and 
tasks are calculated. 


To determine the VORTEX II nucleus size, select entries from 
tables 2-9 through 2-15 and enter the results into the worksheet 
(figure 2-5) in the following manner: 


Select driver and controller table sizes from 

tables 2-9 through 2-12, Each type of device requires 
only one driver, even though there mav be more than 
one of the same device in the system. However, for 
each master device there is one controller. Thus, 

if a system has two master teletvnes, it needs one TTY 
driver and two controller tables. Slave units do 

not require a controller, so if a svstem has one 
master disc with one slave disc, it needs one 
appropriate disc driver and a single controller tahle. 


Select the executive components size from table 2-14. 


Select other tables and low memory linkage from 
table 2-13. A minimum svstem consists of three 
devices, one PIM, eight partitions, no forerround 
common and no retry stack. 


Add the results of steps a, h, and c for the total 
size or the VORTEX nucleus. 


For VTAM svstems, add the central memory requirements 
in table 2-15. 


Add central memory requirements for the various 
foreground and background tasks from table 2-16. 
These requirements are necessarv only if the 
requested programs are loaded and active at the 

same time. Central memory requirements for fore- 
ground are cumulative, i.e., if three foreground 
programs are to he loaded and active, then the 
central memory required is the sum of the program's 
individual central memory .requirements., The central 
memory requirements for hackground are not cumulative, 
because only one background can be resident at one 
time. 
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NOTE: JCP must be resident to load any background program 
and is overlayed during the loading. 2.5K for JCP is the 
minimum background, if any background is used. 


OPCOM must be resident in order to schedule any foreground or 
background task. 


i tit Ml ns 
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Memory Required 
Controller 
Driver 


Table Driver 


Table 
Controller Subtotal Total 


Keyboard Devices TTY (70-6100, 
{one or more -6102, -6104) or 
needed) CRT (£2250) 


RMDs 
(one or more 
needed) 


DOA (70-770x) 
DOB (70-7600, 

-7610) 
DOC (70-7500) 
DOD (70-7510) 


High-Speed 
Input Devices 
(one or more, 
or 2 RMDs) 


MT (70-7100, 
-7102, 
-7103 
CR (70-6200) 
PT (70-6320) 


Optional 
Devices 


LPOA (70-6701) 
CP (70-6201) 
LPOD (70-6602, 
-6608) 
LPOE (70-6602/ 
-6608 with 
31-152 
LPOG (70-6602/ 
-6608 with 
31-142 & 152 
LPOH (70-6641/ 
-6642 with 
31-152) 
LPOJ (70-6611, 
-6613, -6615 
-6617, -6621 
-6623, ~6625 
-6627) 


VORTEX II 
Tables and 
Low Memory Area 


Minimum Systen 


Additional I/O Tables 12/extra device 


Devices (in PIM 40/extra PIM 
addition to PST 3/extra partition 
minimum Foreground Varies 

system) Common 


Retry Stack Varies 


Executive 
Components 


System Tasks (1/0 
Control, RTE) 

SPOOL subsystem 

WCS 

Process Input 

Process Output 

Reentrant FORTRAN 


6043 


1349 + 349/stream 
75 

331 + 16/controller 
198 + 25/controller 

3126 x 


VORTEX I1I/VTAM CCM Components 3225 


System Line Tables 17/line 
(only VTAM DCM Multiplexor $12 

systems need TCM Components 2775 

this memory) Terminal Tables 17/terminal 


Nucleus Total 
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Table 2-16, 


Function 


Foreground Tasks 


Memory required 
is the sum of 
all FL tasks 
resident at one 
time. 


Background Tasks 


Only one BL 
task may be 
resident at 
one time. 


VTT1-3093 


Program 


JPDUMP 
RAZI 
OPCOM 
MIUTIL 


VTAM overlays 


WCSRLD 
HASP/RJE 


JCP 
DASMR 
FORTRAN 
RPGC 
RPGRT 
LMGEN 
FMAIN 
SMAIN 
CONC 
IOUTIL 
SEDIT 
MICSIM 
MIDAS 
NDM (VTAM) 
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Memory 
Required 


2.5K 

8.5K+symbol table 
10,0K+symbol table 
6.5K+symbol table 
6.5K+symbol table 


+ Nucleus 


Total Memory 


Required 


VORTEX II Memory Requirements for Library Routines 


Calculation 


Total 


Foreground 


+ Required 
Background 


a. 
b. 
Ce 
d. 


VORTEX II Configuration Examples: 
required for the nucleus of a minimum VORTEX II system. A 
minimum system must consist of a console device, an RMD, and 
a high-speed input device, 
the minimum values from table 2-13 and 2-14, 
let the system consist of the following: 


Figure 2-6 shows the calculation. 
1024 gives the memory requirement in units of K words. 
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Calculate the memory 


Also, it must use memory equal to 
For this example, 


TTY 

RMD model number 70-770x 
Card reader 

PIM 


actual calculations are as follows: 


From table 2-9, one TTY driver and one controller 
table 


From table 2-10, one RMD driver (70-770x) and 
one controller table 


From table 2-11, one card reader driver and one 
controller table 


From table 2-12, no optional devices 


From table 2-13, no additional devices, use 
minimum 

From table 2-14, use precalculated total for 
systems tasks, without process I/O or reentrant 
FORTRAN, 


Dividing the total by 


2-17 
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Controller Table 
Function Device Driver Table Driver Controller Subtotal Total 
TTY (70-6100, 
f /049 22 /G7/ /O71 
1026 170 1/96 /17E 


-6102, -6104) or 
573 18 
448 98 448 98 GAG 546 


Keyboard Devices 
(one or more 
needed) 


CRT (E2250) 


RMDs 
(one or more 
needed) 


DOA (70-770x) 
DOB (70-7600, 

-7610) 
‘DOC (70-7500) 
DOD (70-7510) 


High-Speed MT (70-7100, 
Input Devices -7102, 
(one or more, -7103 


or 2 RMDs) CR (70-6200) 


PT (70-6320) 


Optional 
Devices 


LPOA (70-6701) 
CP (70-6201) 
LPOD (70-6602, 
-6608) 
LPOE (70-6602/ 
-6608 with 
31-152 
LPOG (70-6602/ 
-6608 with 
31-142 § 152 
LPO (70-6641/ 
-6642 with 
31-152) 
LPOJ (70-6611, 
-6613, -6615 
-6617, -6621 
-6623, -6625 
-6627) 


VORTEX II 
Tables and 
Low Memory Area 


Minimum Systen 


Additional 1/0 Tables 12/extra device 


Devices (in PIM 40/extra PIM 
addition to PST 3/extra partition 
minimum Foreground Varies 

system) Common 


Retry Stack Varies 


Executive 
Components 


System Tasks (1/0 
Control, RTE) 
SPOOL subsystem AQ 

wcs 75 

Process Input 331 + 16/controller 
Process Output 198 + 25/controller 
Reentrant FORTRAN 3126 


1349 + 349/stream 


VORTEX II/VTAM CCM Components 3225 


System Line Tables 17/line 
(only VTAM DCM Multiplexor $12 

systems need TCM Components 2775 

this memory) Terminal Tables 17/terminal 
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ae 
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Ce 
d. 
e. 
f. 


ae 


b. 


Ce 
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VORTEX II EXAMPLE 2 


Calculate the central memory required for the nucleus of 
a VORTEX II system containing the following: 


(one each unless specified otherwise) 


TTY 

CRT 

RMD model number (70-7500) with ten partitions 
RMD (70-7610) with ten partitions 

Two magnetic tape devices (both master units) 
Card reader 

Paper-tape unit 

Card punch 

Line printer (70-6701) 

Two PIMs 

Process I/0 

Reentrant FORTRAN 

Six empty TIDBs 

0200-word common area 

100-word retry stack 

Writable control store 


The calculation, shown in Figure 2-7, for this sample system 
is as follows: 


From table 2-9, one TTY/CRT driver, one controller 
table for TTY and one for CRT 


From Table 2-10, one 70-7500 driver and its controller 
table, and one 70-7610 driver and its controller table 


From Table 2-11, one magnetic-tape driver and two 
controller tables, one card reader driver and its 
controller table, and one paper-tape driver and 
its controller table. 


From Table 2-12, one line printer driver and its 
controller table and one card punch and its controller 
table 


From table 2-13, add 
7 additional I/0 tables 
1 additional PIM 
12 additional PSTs 
Foreground common 
Retry stack 


The number of TIDBs is not necessary for VORTEX II memory 
determination. 
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fs From table 2-14, use the total for system tasks 
plus the values for writable control store, process 
input with 2 controllers, process output wien 2 
controllers and reentrant FORTRAN. 


The total nucleus size determined from the te above is 
added to the library requirements (see figure 2-8) to 
determine the total memory requirements. 
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Function 


Keyboard Devices 
(one or more 
needed) 


RMDs 
(one or more 
needed) 


High-Speed 
Input Devices 
(one or more, 
or 2 RMDs) 


Optional 
Devices 


VORTEX II 
Tables and 
Low Memory Area 


Additional 
Devices (in 
addition to 
minimum 
system) 


Executive 
Components 


VORTEX II/VTAM 
System 
(only VTAM 
systems need 
this memory) 


TTY (70-6100, 
-6102, -6104) 
CRT (E2250) 


DOA (70-770x) 
DOB (70-7600, 

-7610) 
DOC (70-7500) 
DOD (70-7510) 


MT (70-7100, 
-7102, 
-7103 
CR (70-6200) 
PT (70-6320) 


LPOA (70-6701) 

CP (70-6201) 

LPOD (70-6602, 

-6608) 

LPOE (70-6602/ 
-6608 with 
31-152 - 

LPOG (70-6602/ 
-6608 with 
31-142 & 152 

LPOH (70-6641/ 
-6642 with 
31-152) 

LPOJ (70-6611, 
-6613, -6615 
-6617, -6621 
-6623, -6625 
-6627) 


Minimum Systen 


I/O Tables 
PIM 

PST 
Foreground 
Common 
Retry Stack 


System Tasks (1/0 
Control, RTE) 
SPOOL subsystem 

Wwcs 

Process Input 
Process Output 
Reentrant FORTRAN 


CCM Components 
Line Tables 

DCM Multiplexor 
TCM Components 
Terminal Tables 


A is 44. 
452 sol 


12/extra device 
40/extra PIM 

3/extra partition 
Varies 


Varies 


6043 


1349 + 349/stream 

75 

331 + 16/controller 
198 + 25/controller 
3126 ~ 


3225 
17/line 
$12 
2775 
17/terminal 


Memory Required 

. Controller 
Driver Table Driver Controller 
7 Ais : 


172 /14 2 P72 

S73 3G 
98 448 78 
20 535 20 
44 


ieee | 
10G3 


13/4 
/5 76 


604 
S46 
eo Foo 3 


FG/ 
BBS 


Nucleus Total /8O6Z 
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Memory 
Required 


Function Program Calculation 


J PDUMP 
RAZI 
OPCOM 
MIUTIL 
VTAM overlays 
WCSRLD 
HASP/RJE 


Foreground Tasks 


Memory required 
is the sum of 
all FL tasks 
resident at one 
time. 


Total 
Foreground 


JCP 
DASMR 
FORTRAN 
RPGC 
RPGRT 
LMGEN 
FMAIN 
SMAIN 
CONC 
IOUTIL 
SEDIT 
MICSIM 
MIDAS 

NDM (VTAM) 
VSORT 


2.5K 

8.5K+symbol table 
10,0K+symbol table 
6.5K+symbol table 
6.5K+symbol table 


Background Tasks 


Only one BL 
task may be 
resident at 
one time. 


+ Required 
Background 


+ Nucleus 


Total Memory 
Required 


VTI1-3012 


Figure 2-8, VORTEX II Memory Requirements for Library Routines 
2-22 
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SECTION 3 
HARDWARE CONFIGURATION CONSIDERATIONS 


Figure 3-1 shows the minimum VORTEX system configuration. Figure 
3-2 shows the minimum VORTEX II system configuration. Figure 
3-3 shows the minimum requirements for system running particular 


| 
3.1 MINIMUM HARDWARE CONFIGURATIONS 
applications such as VTAM. 


3.2 FEATURES OF PERIPHERAL DEVICES 


Table 3-1 gives the operating and transfer speed, and storage | 
Capacities, where applicable, of peripheral devices. | 


Table 3-1. Features of Peripheral Devices 


| 
Model Device Operating Transfer Storage | 
| 


Number Name Speed Speed Capacity | 
70-6310 Paper Tape Punch 60/120 CPS --- 
70-6300 Reader 300 CPS | 
70-6201 Card Punch 35 CPM 1 Character -s- | 
= 21 ms 
57.2 CPS 
70-6200 Card Reader 300 CPM --- 
70-7500 Disc Memory 12.5 ms 156K words 
Track Access per second 14.6M 
(average) 
70-7510 Disc Memory 12.5 ms 156K words 
Track Access per second 46.7M 
(max. ) 
70-7600 Disc Memory 60 ms 92K words 2,338K 


Track Access per second 


70-7611 Disc Memory 60 ms 92K words 1,170K 
Track Access per second 


CPS 
CPM 


Characters per second 
Cards per minute 


CAs 


SSTZ-TILA 


INTERRUPT 


Device BIC SEEK CHARACTER MOTION STATOS 
COMPLETE | COMPLETE | READY 

Disc- Xx 

Except 70-7610 

Disc Co Per 

70-7610 X Co 


70-6603 
STATOS 


70-6602 
STATOS 


a A a A CO PAR SO 


DIRECTLY CONNECTED INTERRUPTS 


Output i Control 
Byte Character 
Count=0 Detected 


Table 3-2. Relationships of Interrupts and Peripheral Devices 
or PIMs 


2 ea or IE ETRE RET ROT Sehr on Foor cing gRe tre eine itcrt cca eat ta enn a ere era aeons ern a RN ARREST Nt andere ere anne eae tet nti enabancsesne se Re i sabes ch nade aa Ot 


rh chen bs AN aR Aa 


* (UOT eWIOFU 
pueddy ‘II XdLYOA ‘XHLYOA) SWId 10 sadtaap 


Te1rzoydtzod pue szdniidszut u9s9mMzZ9q SUOTJIETSL OY SMOUS Z-¢ OTQE]L 


: 


a WwW 
ie) e 
ae WwW 
Q 

= 

rsh) 

4 

@ 

a 

fe, 

= 

rh 

fae 

vq 

= 

ve 

ts] 

ct 

fe 

\e) 

=} 

fJe 


SWId QNV SHOIASG TWYXHdINed WOUA SLdNudaLNi 


< 
pt ® 
rad mH 
oe | 
. 2. 
a = 
oO pel) 
4 3 
a ° 
° =z 
=| Ee a 
aw} = 
ra @ 
oO ~” 
ct 
° @) 


varian data machines @ 


CENTRAL PROCESSOR FEATURES 


70-SERIES CPU OR REAL-TIME MEMORY 
620/f, 620/f-100 CLOCK PROTECTION 


12K MEMORY POWER OPTIONAL 
FAI LURE/ INSTRUCTION 


(16K FOR FOREGROUND RESTART SET 
§& BACKGROUND) 


PRIORITY INTERRUPT 
MODULE (PIM) 


RMD on PIM with 
BIC or PMA 


TTY (70-6100, -6102, CARD READER WITH A BIC 
-6104) or CRT (E2250D) or 
PAPER-TAPE READER/SYSTEM 


or 
MAGNETIC-TAPE WITH A BIC 


VTI1-2147 


Figure 3-1. Minimum VORTEX System 


CENTRAL PROCESSOR 


70-SERIES CPU 
WITH MEMORY MAP 
HARDWARE 


32K MEMORY 


RMD on PIM with 
BIC or BTC 


PRIORITY INTERRUPT 
MODULE (PIM) 


TTY (70-6100, -6102, 
-6104 on PIM) or CRT 
(E2250D) 


CARD READER WITH A BIC 


or 
PAPER-TAPE READER/SYSTEM 
or 
MAGNETIC-TAPE WITH A BIC 


VTI1-2148 


Figure 3-2. Minimum VORTEX II System 


VTAM SYSTEM 


MINIMUM VORTEX OR 
VORTEX II SYSTEM 


LINE ADAPTORS 
AS REQUIRED 


DATA COMMUNICATIONS 
MULTIPLEXOR (DCM) 


OR 


TERMINAL UNITS 
SUPPORTED BY ADAPTORS 


BINARY SYNCHRONOUS TERMINAL UNITS 
COMMUNICATIONS (BSC) SUPPORTED BY BSC 
FACILITY 


VTI1-2149 


Figure 3-3. Other Minimum Requirements 


3-4 
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Sharing memory between multiple processors may be accomplished 
in two ways. One of these, sharing foreground common, is 
available under both VORTEX and VORTEX II. The other method is 
available only under VORTEX II. 


Sharing Foreground Blank Common: The shared memory is a part of 
e area which is e foreground blank common. VORTEX allocates 
foreground blank common at the top of its available memory as 
specified by the memory parameter of the MRY directive during 
system generation. VORTEX II allocates foreground common at 

the top of its available memory in the first (lowest address) 
physical 32K, also as specified in the MRY directive at system 
generation, In either VORTEX or VORTEX II, the "common" 
parameter of the MRY directive must include all the shared 
memory. 


For example, in the VORTEX configuration shown in figure 3-4 

the 24K memory module on CPU 1 has physical addresses 0 through 
057777 and the shared 8K module has physical addresses 060000 
through 077777. On CPU 2, the 16K module has physical addresses 
0 through 037777 and the shared 8K module has physical addresses 
040000 through 057777. The system generation MRY directive for 
CPU 1 is 


MRY ,077777 ,020000 

The MRY directive for CPU 2 is input as follows: 

MRY ,057777 ,020000 

A similar example for VORTEX II would be the configuration 
shown in figure 3-5. The first 32K addressing would be the 
same as the preceding example. The added 16K module on CPU 

1 would have physical addresses 0100000 through 0137777 and 
the additional 32K module on CPU 2 would have physical addresses 
0100000 through 0177777. The system generation MRY directive 
for CPU 1 would be 

MRY ,077777 ,020000 ,48 

The MRY directive for CPU 2 would be 


MRY ,077777,020000,64 


varian data machines (ae 
3.4 SHARING MEMORY UNDER VORTEX AND VORTEX II 
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24K 
(0-24K) 


VTI1-2150 


Figure 3-4, Shared Memory Configuration under VORTEX 


32K 
24K 24K (32-64K) 
16K (0-24K) (0-24Kk) 


(32-48K) | aK | 


CPU 1 CPU 2 


Figure 3-5. Shared Memory Configuration under VORTEX II 


VTI1-2151 
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In either of the examples, the memory could have been reserved 
for AID, BLD or DCM requirements by modifying the "memory" 

and "common" parameter values on the MRY directives. For 
example, if 512 words were to be reserved for DCM use in the 
VORTEX configuration the MRY directive for CPU 1 would be 


MRY ,076777 ,017000 
The MRY directive for CPU 2 would be 
MRY ,056777 ,017000 


omar ing Menon. by Tasks (VORTEX II only): The second method 
available only under provides memory sharing by 
withholding memory from system use and providing the RTE 
request, MAPIN, which allows the user to assign the withheld 
memory dynamically to the executing tasks. Management of the 
shared memory is entirely under the control of, and the 
responsibility of the tasks. The shared memory must. 

have physical address at the top of the first 32K or at the 
top of available memory. 


For example, in the VORTEX II configuration shown in figure 3-6, 
the 24K module on CPU 1 would have physical address 0 through 
057777 and the shared 8K module would have physical addresses 
060000 through 077777. The 16K module would have physical 
addresses 0100000 through 0137777. 


On CPU 2, the first 32K would have physical addresses 0 through 
077777, the 24K module would have physical addresses 0100000 
through 157777 and the shared 8K module would have physical 
addresses 0160000 through 177777. 


varian data machines @- 


24K 
(32-56K) 


32K 
(0-32K) 
CPU 2 


24K 
(0-24K) 
CPU 1 


16K 


VTI1-2152 


Figure 3-6. Shared Memory Configuration under VORTEX II 
(Sharing by Tasks) 
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In the system generation with no foreground common allocated 


in CPU 1 and 128 words of foreground common allocated in CPU 2, 


the MRY directive for CPU 1 would be 
MRY ,057777,0,48 

In the same situation for CPU 2 the memory directive would be 
MRY ,077777 ,0200,64 


If CPU 2 required 512 words to be reserved for a DCM, its MRY 
directive would be 


MRY ,076777,0200,64 


Memory withheld by this method is never assigned or otherwise 
modified by VORTEX II. An executing task accesses the shared 
areas by use of the VORTEX II RTE request, MAPIN. The MAPIN 
request allows a task to assign physical memory pages to a 
task's logical memory. For example, a task executing in 

CPU 1 in this example, requesting access to the first three 
pages of shared memory, makes the following request: 


MAPIN 3,05000 ,48, ERR 


Execution of this request causes the VORTEX II Executive 

to assign physical pages 48, 49, and 50 to the task's logical 
addresses 05000 through 07777, In this configuration CPU 1's 
reserved memory is physical pages 0 - 47 and 64 - 95; 

its shared memory is physical pages 48 - 63. CPU 2 has 
reserved memory from physical page 0 to 111 and shared memory 
from physical pages 112 through 127. 


The same task as above executing in CPU 2 would make the 
following request: 


MAPIN 3,05000,112,ERR 


If the load module of the above task required three pages of 
memory, the task's logical memory after execution of the 
MAPIN request would be as in figure 3-7. The entire 8K of 
shared memory could have been mapped in if 16 pages were 
requested instead of 3. 


varian data machines 


0 
PAGE 0 
SYSTEM COMMUNICATIONS AREA 
01000 
04000 
05000 
010000 
077777 


VTI1-2153 


Figure 3-7. Example Task's Logical Memory 
After MAPIN Request 


FIRST 3 PAGES OF SHARED MEMORY 
3-10 


3.5 REQUIRED HARDWARE REVISION LEVELS 
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For 620/f and 620/f-100 systems, the following revision levels 


are suggested for a highly reliable system: 


Module 


Part Number Revision 
Power Failure/Real-Time Clock 44P0483 P 
Memory Protection ~—44P0480 L 
Optional Instructions 44P0444 H 
CPU Connector Board (620/f) 44P0452 AR 
CPU Connector Board (620/f-100) 44P0581 P 
I/O Control 44P0442 V 
I/O Data 44P0443 G 
DL 12-15 44P0448 K 
DL 8-11 44P0447 P 
DL 4-7 44P0446 L 
DL 0-3 44P0445 L 
Control 1 44P0449 M 
Control 2 44P0450 P 
Clock Board 44P0440 J 
TTY/ABL 44P0451 J 
BIC 44P0026 S 
or 44P0689 A 
7-track Magnetic Tape 44P0243 J 
44P0245 D 
9-track Magnetic Tape 44P0232 Pp 
44P0233 E 
VRC Drum (620-47,-48 and -49) 44P0294 c* 
PIM 44P0172 S 
or 44P0683 A 


*with modification for CPU power off 


3-11 
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SECTION 4 
SYSTEM GENERATION LIBRARY (SGL) 


The system generation library (SGL) is a collection of programs 
on magnetic tape, punched cards, or disc. pack. It includes all 
the programs, except the key-in loader (VORTEX, VORTEX II, 13.3), 
and 70-7500/7510 RMD formatter, for generating a VORTEX or VORTEX 
II system on an RMD. 


4.1 CONTENTS OF SYSTEM GENERATION LIBRARIES 
With the release of revision D of the VORTEX/VORTEX II SGLs, 


the contents of the various files are described in tables 
4-1 and 4-2. 


Table 4-1. Contents of Magnetic-Tape and Card SGLs 


File number Contents 

1 SGL 

2 and 3 Basic OM library job stream 
(without WCS) 

4 and 5 Software OM library job stream 

6 and 7 Accelerator OM library job stream 

8 and 9 Floating-Point Processor (FPP) 
OM library job stream 

10 and lil FPP with accelerator OM library job 
stream 

12 and 13 Floating-Point firmware supplement 
to software OM 

14 through 28 VTAM job streams 

29 and 30 Basic Dataplot II OM job stream 

31 and 32 VORTEX compatible Dataplot II OM 


job stream 


33 and 34 MOS compatible Dataplot II OM 
job stream 
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All job streams terminate immediately before their last file 
mark, i.e. the basic OM stops before file mark 3. 


The driver for the card reader has been modified to handle 
skip file and skip record requests. 


The SGL and OM libraries on a disc pack occupy two partitions 
of 100 tracks each. SGL uses partition A and the OM libraries 
use partition B. The OM libraries do not have job streams 
(object only). 


Table 4-2. Contents of Disc-pack SGLs 


File Name Contents 

BSCOM Basic OM 

SFTOM Software OM 

ACLOM Accelerator OM 

FPPOM Floating-Point Processor OM 
FPAOM FPP with Accelerator OM 
FPFOM Floating-point firmware OM 
several* VTAM OM 

BDPOM Basic Dataplot II OM 

VDPOM VORTEX Compatible Dataplot II OM 
MDPOM MOS Compatible Dataplot II OM 


® consists of several files as described on the VTAM B 
release bulletin. 


4-2 


i 
| 
i 


4.2 SYSTEM GENERATION (SGEN) 


in main memory and on an RMD. 


or VORTEX II, SGEN does the following: 


a. 


ge 


Figure 4-1 is a flowchart of the SGEN routines and functions, 


gives information to VORTEX or VORTEX II about 
peripherals are in the system, and where they 
are in terms of their devices addresses 


partitions the RMDs to accomodate the system, its 
library, scratch areas, etc. 


assigns the priorities of the peripherals 


configures the software to the user's requirements 
through ADD, DELETE and/or REPLACE directives 


builds the nucleus in main memory and copies 
it to the system RMD 


creates load modules for the system foreground 
and background tasks 


loads and executes the system initializer 
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System generation (SGEN) is the creation of an operating system 
To configure the system for VORTEX 


VORTEX 
BOOTSTRAP 
LOADER 


VORTEX 
INTERROGATION 
ROUTINE 


10 
INTERROGATION 


V$SGENIO 
LOAD 
V$SGENLD 


V$SGENLD 


LOAD 
V$SGEN1 


V$SGEN1 


DIRECTIVE 
PROCESSOR 


BUILD BAD 
TRACK & 
PARTITION 

SPECIFICATION 
TABLES 


[ VS$SGENLD \ 


LOAD 
V$SGEN2 


VTI2-417A 


Figure 4-1, 


READS FIRST 30 RECORDS FROM 
SGL. SGEN BOOTSTRAP LOAD 
FROM LOC. 0 


V$SGENIO LOADS ABSOLUTELY 
FROM 0500. DETERMINES MEM. 
SIZE & SETS POINTER TO 027777 
OR TOP MINUS 02000 WHICHEVER 
IS GREATER. 


DEFINE PERIPHERALS TO BE 
USED BY SGEN. 


RELOCATABLE LOADER AND I/O 
CONTROL. LOADS DOWN FROM 
LOCATION SET BY POINTER. 


LOADS UPWARD FROM 0500 


PROCESS SGEN DIRECTIVES. 
(DEFINITION OF ENVIRONMENT IN 
WHICH VORTEX WILL OPERATE.) 


THE STANDALONE FORMATTER PERFORMS THE 
BAD TRACK ANALYSIS ON 70-7500 AND 
70-7510 RMD. 


NUCLEUS GENERATOR. 
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V$SGEN2 


CONSTRUCT 
VORTEX 
NUCLEUS 


V$SGENLD 


LOAD 
V$SGEN3 


INPUT & 
PROCESS 
LIB. GEN. 


LOAD 
V$SGEN4 


LOAD 
VORTEX 
NUCLEUS 


VORTEX 
SYS, READY 


NOTE: 


REFERENCE SGEN 
DIRECTIVES AND 
SGL INPUT. 


LIBRARY GENERATOR. 


LIBRARY GENERATOR 
CONTROL RECORDS 
AND OBJECT 
MODULES FROM SGL 
AND ALT. UNIT. 


RESIDENT TASK 
CONFIGURATOR, 


GENERATE CORE 
RESIDENT DIREC- 
TORY AND CORE 
ALLOCATION MASK 
TABLE AND COPY 
TO NUCLEUS. 


VORTEX INITIALIZER 
IS LOADED AND 
EXECUTED. 


THIS LEVEL. OF 


SYSTEM GENERATION IS 
THE SAME FOR VORTEX 
AND VORTEX II SYSTEMS 


Flowchart of System Generation 
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4.3  RMDs for SGEN 


At least one RMD (disc or drum) is required for storage 
of the operating system components. The RMD is divided into 
a fixed number of variable-length areas called partitions. 


These are defined during system generation (VORTEX, VORTEX II, 


Section 13). 


The following reside on the RMD: 


ae 


b. 
Ce 


d. 


System initializer, loader, and nucleus in 
absolute format 


Checkpoint file, normally associated with CU 
GO file, normally associated with GO 
Foreground library, normally associated with FL 


Transient files, normally associated with PO, 
SS ,SW 


Relocatable object-module library, normally 
associated with OM 


Background load-module library, normally associated 
with BL 


Table 4-3 is a partial list of the RMDs supported by VORTEX 
and VORTEX II and their sizes. 
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Model Words (16-bit) 
Number Tracks Sectors Per Sector 


Table 4-3, Sizes of VORTEX RMDs 


70-7500 4060 24 120 


70-7600 
70-7610 
70-7702 


For information on partitioning RMDs, see the PRT directive 
in section 6.4, 


4.4 ACCEPTANCE TEST PROGRAM (ATP) 


The Customer Acceptance Test Program (ATP) is designed to 
function within the normal VORTEX hardware and software 
configuration without additional requirements, except for 

an applicable input medium for the ATP job stream. Presently, 
the ATP job stream is available on paper tape, cards, or 
magnetic tape. 


The procedure to execute the ATP is described in the docu- 
mentation accompanying the test (see section 1.2 for software 
part numbers). 
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This section gives combinations of master and slave devices 
allowed and also the permissible mnemonics for peripheral 


4.5 HARDWARE SUPPORTED BY SGL 


devices. 


In the following table, an asterisk before a device name indicates 


that the device is available during system generation. 


units are unit 0 and slave unit start with unit l. 


Combinations of Master and Slave Devices 


Device Device Name 
Master Master Master Master 
: ene 2 3 4 
RMDs 
70-7600 *DOOB ®D10B *D20B ®D30B 
Slave 1 *D01B *D11B *D21B *1N31B 
Slave 2 ®DO2B *D12B *D22B *D32B 
Slave 3 *D03B *D13B *D23B *D33B 
70-7500 *DOOC *N10C *)20C ®D30C 
Slave l *DN01C ®DN11C *D21C ®N31C 
Slave 2 *D02C *N12C ®D22C *D32C 
Slave 3 *DO3C *D13C *)23C *D33C 
70-7510 *D00D ®D10D *DN20D *N30D 
Slave 1 *DN01D *D11D *D21D *D31D 
Slave 2 *p02D *D12D *1)22D *N32D 
Slave 3 *DN0O3D ®D13D *D23D *D33D 
70-7702 ®DOOAL ®*D1OAL1 ®D20A1 *D30A1 
70-7703 ®DO0A2 *DN10A2 *D20A2 *D30A2 
620-49 ®DOOAS ®D10AS5 *D20A5 *D30A5 
Magnetic Tapes 
70-7100 through -7103 
®MTOOA ®MT10A MT20A MT30A 
Slave 1 ®MTO1A *MT11A MT21A MT31A 
Slave 2 MTO2A MT12A MT22A MT32A 
Slave 3 MTO3A MT13A MT23A MT33A 


Master 


Vi ar mem esa a 
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The following table shows the permissible mnemonics for 
peripheral devices. An asterisk before the name indicates 
that the device is available during system generation, 


Model Numbers Names 

Line Printers ®LPOA LP1A 

70-6701 

Statos Printer/plotters 

70-6602 § -6608 *LPOOD LP10D LP20D 
70-6602 & -6608 LPOOE LP10E LP20E 
With 31-152 

70-6602 §& -6608 LPOOG LP10G LP20G 
With 31-142 § 

31-152 

70-6641 §& -6642 LP0OH LP10H LP20H 
with 31-152 

70-6611, -6613, LPOOJ LP10J LP20J 


-6615, -6617, -6621, 
-6623, -6625 § -6627 


Teletypes 

70-6100 through -6104 *TYOOA TY10A through TY60A 

CRTs 

70-6400, -6401 CTOOA through CT60A 

Card Reader 

70-6200 *CROOA 

Card Punch 

70-6201 CPOOA 

Paper Tape 

70-6300 *PTOOA PT10A 

through -6320 

DCM 

70-6201 MXOA MX1A MX2A MX3A © 
through -5213 

Process Output COOA CO1A CO2A CO3A 
Process Input CIOA CI1iA CI2A CI3A 
Spool SPOOA through SP70A 
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SECTION 5 
SYSTEM GENERATION 


This section provides supplementary information and suggestions 
for performing system generation, (VORTEX, VORTEX II, Section 
13). VORTEX II procedures are the same as these for VORTEX 
unless specifically stated otherwise. 


5.1 FORMATTING AND BAD-TRACK ANALYSIS 


Before a 70-7500/7510 disc pack can be used in any function 
under VORTEX or VORTEX II, it must be formatted. This is a 
stand-alone program (requiring approximately 8 minutes (70-7500) 
or 12 minutes (70-7510) per pack to run), which formats the 
disc to 120-word sectors (16-bit words) grouped 24 sectors 

per track. It also performs the bad-track analysis and creates 
the bad track table. 


RMD Model Number Part Number Bad-Track Table 
70-7500 92()0205-025B Sectors 0-2 
70-7510 92()0205-026A Sectors 0-4 


5.2 LOADERS 


There are two types of loaders, SGEN key-in loaders (VORTEX, 
VORTEX a 13.3) and system bootstrap loaders (VORTEX, VORTEX 
LT. 1662) 


To facilitate reloading, these loader routines may be dumped 
onto paper tape using the AID II utility program. The resulting 
paper tape bootstrap may be loaded using BLD II. 


5.3 SYSTEM GENERATION DIRECTIVES 


To execute system generation, load in the appropriate bootstrap 
(VORTEX, VORTEX II, 13.3). The locations specified for RMDs do 
not include model 70-7500 or 70-7510. 


The bootstrap causes the loading of the VORTEX bootstrap from 
the SGL, which in turn loads V$SGENIO. When this is accomplished, 
OC will print or display: I/O INTERROGATION : 
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After this the SGEN peripherals are specified by inputting on 
the OC unit the five I/O directives. Always specify the first 
master unit of a particular device as being on controller 0, 
the second master unit on controller 1, etc., regardless of 
their specifications in the EQP directives. The format for 
the device is the complete hardware name including model code. 
For example, 


Directive Specifies 

DIR=CRO0A,030 SGEN directive input unit 

LIB=MTO0A,011 SGL input device 

LIS=LP00A,035 System list output device. This cannot 
be a dummy device. 

ALT=CROOA,030 Alternate input device. Device from 
which modules to modify the system will 
be input. 


SYS=D00C,015,020 | RMD onto which the VORTEX system will be 
generated, usually referenced as the 
system RMD. 


5.3.1 SYS Directive for Multiple RMDs 


Every RMD in the system must be included in the SYS directive 
with the system RMD first, such as SYS=D00C,015,070;D10B,016,020;... 


A colon at the end of the line indicates that the RMD string 
continues on the next input line. 


Each RMD must have an EQP directive and at least one PRT directive. 
The system RMD must have at least seven PRTs. 


SGEN continues requesting I/O directives until valid input for 
all five functions has been completed. Then SGEN will input 
the SGEN directives and perform bad-track analysis. Then 
V$SGENIO loads V$SGENLD (relocatable loader) which begins 
loading the VORTEX drivers. 


NOTE: There are no expected halts in this process except for 
1/0 interrogation; the most common causes for failure here are: 


a. Wrong Bootstrap Routine 

b. LIB unit (SGL- input) not at beginning of file 

for" Wrong track or density (magnetic tape SGL) 

d. Required peripheral off-line 

e. Key-in errors on I/O interrogation, especially zeros 
and letter 0. 

£. Failure to include all RMDs in SYS directive 


5-2 


varian data machines @ 


The first step in preparing for system generation is to set 
up the input directives (VORTEX, VORTEX II, 13.5). Through 
these directives, the software system knows exactly the kinds 
of peripherals on the system, their locations, and their 
priorities. This is the software counterpart of hardware 
configuration, which is specified in the System Memo. 


5.4 SGEN DIRECTIVES 


The following sections describe the individual directives. 


5.4.1 MRY Directive for VORTEX 
The memory directive is usually the first card. It specifies 
a. the amount of memory available to the system 
(to allow AID II and BLD II to remain at the top of 
central memory, use the form Onx777) 
b. the size of the foreground blank common area, 


which is near the top of memory and used as a 
shared storage area among foreground tasks. 


FORMAT : MRY ,Onx777 ,yyy 


where 
n is 3 for 16K, 5 for 24K, and 7 for 32K. 
x is 5 to save AID II and BLD II or 7 to overlay 
AID II and BLD ITI 
yyy is the size of the blank common area (in words), 


(Customer ATP requires at least ten words; 
200 words will preserve both AID II and 
BLD ITI) 


5.4.2 MRY Directive for VORTEX II 
In addition to the functions for VORTEX, the memory directive 


in VORTEX II systems specifies the total physical memory 
size in units of 1024 words (1K). 


FORMAT : MRY ,Onx777,yyy ,size 


The permissible range of values for size is from 32 through 
256 inclusive. 
5.4.3 MRY Directive for VTAM 


The memory directive on a VTAM system must reflect the DCM's 
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use of a 512 words of memory for hardware control words, 
and must start at a multiple of 512, i.e., 74000,75000. 


Fxample: For a 32K system, saving AID II and BLD II with LCB 
at ETO. | 


MRY ,074777, 200 


5.4.4 CLK Directive 


This directive specifies all the parameters related to the 
real-time clock, 


FORMAT : CLK, XXX yyy ,2Z2 


where xxx is the number of microseconds in the hasic clock 
interval 


is the number of microseconds in the free-running counter 
increment period. 


ZZ is the number of microseconds in the user interrupt interval; 
this value must be from 5 to 50, inclusive, 


The most common form is CLK,100,100,20., 


9.4.5 EOP Directive 
The FOP directive defines the peripherals on the systen. Each 
peripheral -- line printer, card reader, RMD, etc. -- must have 


an [QP card describing it for VORTEX. (VORTEX, VORTEX II, 
Table 13-8, for specific model codes) 


FORMAT : FQP name, address ,bic,retry,alp,mul 


The parameters alg and mul are only applicable to process I/0 
(VORTEX, VORTEX II, 13.5.2). 


[xamples: For Teletype at device address 01: 
FOP .TY 0A, 01..7.20:..0 
no retries 
no BIC address 
Only peripheral on this controller 


device address: for VORTEX there will always be 
a teletype at device address 01. 
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For RMD: 
EQP ,DOB,016,1,020,5 
number of retries 
BIC #1, Must be in OCTAL with leading zero 


There is only one disc in use. This would be 
the fixed pack, on 70-7610 


Device address 016. Must be OCTAL with leading 
zero 


Designates the 70-7600/-7610 type of RMD 
EQP ,DOB,016,4,020,5 


Same as above, except configuring for four 
discs, For example, the 70-7610 has a 
removable and a fixed pack, which each count 
as one unit. This system then has two 70-7610 
on one controller. 


For four CRTs on four separate controllers, 0-3, at addresses 
02 through 05: 


EQP ,CTOA,02,1,0,0 
EQP,CT1A,03,1,0,0 
EQP ,CT3A,04,1,0,0 
EQP,CT3A,05,1,0,0 


For two magnetic tapes in a master/slave configuration: 


EQP ,MTOA,010,2,024,3 


For standard line printer: 


EQP,LPOA,035,1,022,0 


For 70-6602,Statos-31; 
EQP ,LP0D,035,1,022,0 


For a 70-6603, Statos-31 with hardware character generator: 


EQP ,LPOE,035,1,022,0 
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SPOOL Subsystem: To realize greater efficiency from the 
subsystem, use at least two RMDs. Basically, one 

is for the VORTEX or VORTEX II system and includes PO file. 

The other is for the SPOOL files and additional storage. 


An EQP directive is required for each SPOOL file to be created. 
For example, 


EQP ,SP0A,1,1,0,0 


VTAM: VORTEX VTAM requires EQP directives and DEF directives 
for each DCM and TCM. The first DCM must be unit 0: 


EQP ,MX0A,074,1,0,0 
DEF, V$LCWO,075000 (for LCB at 075000) 
EQP,TCOA,00,1,0,0 


VORTEX II VTAM EQP directives are the same as VORTEX. 


5.4.6 PRT Directive 


The partition directive specifies the size of each partition on 
an RMD, 


FORMAT : PRT ,Dcup,s ,k 


where 
Cc is the number of the controller, 0,1,2, or 3 
u is the number of the unit on the controller, 0,1,2, or 3 
p is the letter of the partition, A through T inclusive 
Ss is the number (octal or decimal) of tracks in the 
partition I: 
k is the protection code (a single alphanumeric Spasacess. 


including $) for the partition, or * to indicate the 
partition is unprotected 


Partition directives are required for every partition on every 
RMD in the system with the system RMD having a minimum of seven 
parititions. Each RMD must have at least one PRT card. 
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Examples: Typical PRT cards for various RMDs are: 

70-7500: 
PRT ,DO0A,S50 ,C;DO0B,200,F;DO00C, 200 ,E;D00D,200 ,D;DO0E,200,S 
PRT ,DOOF,500 ,B;N00G,500,* ;D00H,1300,*;DO0I ,500,*;D00J,50,* 
PRT ,DOOK,250,* 


For 70-7600 or 70-7610 


PRT, DOOA,2,C;D00B,14,F;D00C,34,E;D00D,12,D;DO00E,4,S 
PRT, DOOF,6,B;D00G,5,*;DO0H, 81, *;D00I,30,*;D00J,3,*;DO0K,6,* 


For 70-7510: 


PRT ,DOOA,5,C;DO0B,60,F;D00C,50,£;D00D,20,D;DO0E,8,S 
PRT, DOOF,21,B;D00G,15,*;DO0H,80,* 


The above examples of partitions are operating on actual systems. 
They may be used as standards. This will avoid confusion and 
will help gain a measure of confidence in the directives. 


To partition more than one disc on the same controller, use the 
following format: 


PRT ,DO1LA,xxx,*;D01B,xxx,* (Disc number 2) 
PRT ,DO2A,xxx, *;D02B,xxx,* (Disc number 3) 
PRT ,DO3A,xxx,*;D03B,xxx,* (Disc number 4) 


where xxx is the number of tracks in the partition. 


The total number of tracks of all partitions plus the VORTEX 
nucleus must not exceed the RMD'‘'s track capacity. The 

size of the nucleus is equal to the memory size divided by 
the product of the number of sectors per track and 120. For 
this calculation memory will always be less than or equal 

to 32K. 


Example: Calculate the number of tracks for a system with 
a 70-7500 disc: 


32K = 32768 = 11.5 rounds off to 12 
2080 track for the nucleus 
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Calculate the number of tracks for a 32K system with a 
70-7600 disc: 


32K = 32768 = 5.5 rounds to 6 tracks 


The first partition specified by a PRT directive will list in 
the bad-track table as the first sequential track number 
outside the nucleus area. 


The first partition listed in the bad-track table for the 
first example will begin at track 13, and in the second example 
this will be track 7. 


Determining Partition Size: For partitions to contain object 
modules Oi library, GO partitions), calculate 
b 
2(z) 
where b = the number of 60-word binary records 
Z = 


sectors per track 


For partitions to contain load modules (in the background and 
foreground library) calculate 


k 
~ 120 (z) 


where k = memory required for module 
z = sectors per track 


Partitioning for the SPOOL Subsystem: The SPOOL subsystem requires 
a partition on which output data is held waiting for the peripheral 
to become ready. This partition must have the protection key S, 
and correspond to logical unit number 107. 
FORMAT: PRT,Dnna,t,S 
where t = number of tracks in the partition (in octal or decimal) 
Dnna = the name of the partition (this corresponds to the 
ASN directive for logical unit number 107) 
To determine the optimum size for SPOOL output partitions, calculate: 


(a - p) t = output lines = sectors 
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where a = the maximum number of lines per minute a program 
(application, assembler, etc.) is capable of outputting 
unimpaired by the printer 


p = printer speed in lines per minute 

t = maximum time (in minutes) a program would be outputting 
Example: Calculate the sectors required to spool output from 
an assembly expected to generate a thousand lines per minute 
for ten minutes, where the printer speed is 600 lines per 
minute. 
a = 1000, p = 600 and t = 10 
1000 - 600 = 400 
400(10) = 4000 lines of output will backup onto the SPOOL file 
NOTE: The SPOOL files can be any size, but naturally the 
Targer the better up to a point. If the SPOOL file becomes 
full, OC displays 1060, this is only an indicator and can 
be ignored. However, if it occurs frequently, the file sizes 
should be increased if that is at all possible. 
5.4.7 ASN Directive 
The assign directive makes the logical unit number and name 


assignments for physical devices. 


FORMAT: ASN, 1lun(1)=dev(1) ,lun(2)=dev(2Z) ,...,1un(n) =dev(n) 


where each 


lun is a logical unit number (1 through 100 or 107 through 
255, inclusive) which can be followed by an optional 
two-character logical unit name, e.g., 107:Y7 


dev is a four-character physical-device name, e.g., 
TY00 ,DO00G,etc. 


VORTEX requires that logical unit numbers 1 through 12 be 
assigned, 
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A physical device can be assigned to more than one logical 
unit but a logical unit, name or number, cannot be assigned 
to more than one phvsical device. 


Table 5-1 indicates the peripherals these may he assigned and 
their pre-set logical unit names. These are the default 
assignments. 


Table 5-1, 


Logical 
Mnit 


1 
2 
3 
A 


11 
12 


Logical Units, Pre-set Names and Permissible 


Perinheral Nevice Assignments 


Permissible Physical Unit 


Pre-Set RMD Other Other 
Logical Teletvpe or Line Nutput Input 
Name or “CRT MT Printer (cP, PT) (PT,CR) 
NC ne 

ST x X xX 

sn X 

PI X x X 

LO x x x X 

BI X x 

BO X Xx 

SS x 

GO X 

PO X 

NT X X 

no X X 


Examples: 


ASN ,1=TY00 
ASN ,2=TY00 
ASN , 3=TY00 
ASN ,4=CRO0 
ASN ,5=LP00 
ASN ,6=CROO 
ASN ,7=CP00 
ASN ,8=DO0H 
ASN ,9=D00G 
ASN ,10=D00H 
ASN ,11=TY00 
ASN ,12=TY00 
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ASN ,13:CR=CROO 
ASN ,14:CP=CP00 
ASN, 15: LP=LP00 
ASN , 16 : AD=DUM 

ASN,17:CT=TY00 
ASN ,18 :MO=MT00 
ASN , 19 :M1-MT10 
ASN , 20 :M2=MT20 
ASN, 21:DF=DO1A 
ASN ,22:DE=D01B 
ASN, 23:SD=DOOI 
ASN, 24:PP=LP10 


VORTEX requires the following logical unit/RMD relationships. 
These are inherent in VORTEX and VORTEX II and do not require 
ASN directives, however PRT directives are required, 


Table 5-2. Pre-Set Logical-Unit/RMD Partition Relationship 


Logical 
Unit 
Name 

CL 

FL 

BL 

OM 

CU 


SW 


Restrictions: 


Logical 

Unit Partition Protection 
Number Name Key 

103 DOOA C 

106 DOOB F 

105 DOOC E 

104 DOOD D 

101 DOOE S 

102 DOOF B 


Minimum 
VORTEX Sector 
Allocation 
025 

0106 

01135 

0417 

0310 


0310 


Any attempt to change one of the preset 


logical unit name number or name-number-partition 
relationships given in Table 5-2 will cause an error 
to be flagged. 
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Table 5-3. Optional Logical Unit and RMD Partition Relationships 


Logical Minimum 
Logical Unit Partition VORTEX Sector 
Name Number Name Allocation 
GO 9 DOOG 0310 (see note 1) 
SS 8 DOOH varies 
PO 10 DOOH 0515 (see note 2) 
BI 6 DOOTI varies 
BO 7 DOOI varies 


These files must not have protection keys. 
NOTES: 


1. GO file must be larger than the largest task run in 
load-and-go mode. If the system is foreground only 
or all tasks will be entered in libraries before 
execution, this partition may be eliminated. 


Ze PO file must be large enough for source images of the 
largest task to be assembled or compiled. Source 
images are stored three card images per sector (above 
assumes 1000 cards). If this function is assigned to 
magnetic tape, this partition may be eliminated. 


Logical units 13, 14 and 15 are used by RPG as CR, CP and 
LP, respectively and should be assigned (if RPG is to be 
used). 


NOTE: It is advisable to include extra logical unit numbers 
assigned to dummy units, for example: 


ASN ,39: DD=DUM 
ASN ,53:BP=DUM 


This makes these numbers available for temporary assignment 
through OPCOM and JCP. 


VORTEX SPOOL Subsystem: The only permissible changes to the 
preset logical unit numbers and names are when generating 
the VORTEX system with the SPOOL subsystem. In this case, 
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the following is an example of possible changes: © 


Standard SPOOL 

VORTEX Subsystem 

ASN , 5=LP00 ASN,5=SP00 (list output) 

ASN ,7=CP00 ASN,7=SP10 ‘(punched card BO) 
ASN ,xx=MT00 ASN,xx=SP20 (magnetic tape) 


Each of the SPnn assignments is then associated with a 
logical unit 180-187, to which the output is written. 


ASN,180:S0=LP00 
ASN, 181:S1=CP00 
ASN,182:S2=MTOO 


The RMD partition created for the SPOOL files must be 
assigned to logical unit 107, with the logical name SX 
with the protection key S. | 


SGEN does not permit file creation, the SPOOL file will be 
created using FMAIN after the system generation is complete. 
Section 5.6 describes the SPOOL subsystem file creation. 


VORTEX VTAM: An ASN directive is required for each multiplexor 
and each terminal controller. For example, 


ASN ,27:MC=MX00 
ASN ,28:TT=TCOO 


5.4.8 PIM Directive 


The PIM, Priority Interrupt Module, directive defines the interrupt 
system architecture by specifying the number of priority interrupt 
modules (PIMs) in the system, (the System Memo describes the 
specifications of a particular system), the interrupt levels to 

be enabled at system initialization, and the interrupts to be 
manipulated by interrupt handlers coded by the user. 


FORMAT: PIM,p(1),q(1),r(1),8(1)3p(2) ,q(2) ,r(2) : 


s(2);...3;p(n) ,q(n) ,r(n) ,s(n) 
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p is an interrupt line number comprising two 
octal digits with the first being the PIM 
number (PIM 1 = 0, 2 = 1), and the second 
is the line number within the PIM (0 
through 7). The two digits must be pre- 
ceded by a zero, e.g., 002, O11. 


where each 


q is the name (1 to 6 characters) of the 
task handling the interrupt. The format 
of the name is TBxxxx, where xxxx is the 
hardware code name given in the EQP 
directive. 


r is the content of the interrupt event word 
in octal notation (VORTEX, VORTEX II, 
Appendix F for non-zero values for standard 
hardware). 


Ss is 0 for an interrupt using the common 
interrupt-handler, 1 for a directly 
connected interrupt option 1, or 2 for 
a directly connected interrupt option 2. 


If an interrupt line is to use the common interrupt handler, 
a TIDB is generated for the related interrupt-processing 
routine, which can be in the VORTEX nucleus or in the 
foreground library. 


If an interrupt line is to have a direct connection, the 
interrupt-processing routine must be added to the nucleus. 
Failure to do so results in an error message, 


Example: Specify two interrupt lines, one handled by the 
common interrupt handler, the other directly connected. 


PIM,002,TBMT0A,01,0;003,TBLPOB,01,1 


NOTES: 


1. The only interrupt used by the magnetic-tape I/0 
driver is the motion complete (see section 3.3 for 
interrupts used by peripherals). 
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2. The RMD which contains the VORTEX system must be on 
the highest priority BIC in the system 


5% RMDs, 70-7500 and -7600, require two PIM lines, BIC 
complete and seek complete. 70-7610 requires BIC 
complete and two seek completes (one for each platter). 


4. When more than one peripheral is connected to a BIC, 
a PIM directive for any one of them will result in 
all being identified. Therefore, only one PIM 
directive is required for the group. 


For VTAM systems, each DCM defined by an EQP directive must 
have six PIM directives, see section 3.3 (and VTAM,11.7). 


For VORTEX these are handled by the common interrupt handler, 
and for VORTEX II by a directly connected handler. 


STATOS: The Statos-31 with hardware character generator 
requires three PIM directives, (see section 3.3). 


Examples: Typical examples of PIM directive using the common 
interrupt handler are 


For BIC complete on 70-7500 RMD: PIM,000,TBDOC,01,0 


For card reader: PIM,001,TBCROA,01,0 
For seek complete: PIM,002,TBDOC,01,0 

For paper tape: PIM,005,TBPTO0A,01,0 
For TTY Read, PIM 2, Line 6: PIM,016,TBTYOA,01,0 
For TTY Write, PIM 2, Line 7: PIM,017,TBTYOA,02,0 


5.4.9 EDR Directive 


The EDR, End Redefinition, directive must be the last SGEN 

directive. It specifies all special system parameters, and 
terminates SGEN directive input. If only a redefinition of 
resident tasks is required, the EDR directive is of the form 


EDR,R. 


varian data machines @ 


If a full SGEN is necessary, the EDR directive has the general 
format. 


FORMAT: EDR,S,tidb,stack,part,list,kpun,map,analysis 


where | 
tidb in VORTEX II systems, is ignored (as all TIDBs 
are dynamically assigned) 


in VORTEX systems, is the number (01 through 
0777, inclusive) of 25-word empty TIDBs allocated. 


stack is the size (0 through 037777, inclusive) of 
the storage and reentry stack allocation, which 
is equal to the number of words per reentrant 
subroutine multiplied by the number of levels 
calling the subroutine 


part is the maximum number (7 through 20, inclusive) 
of partitions on an RMD in the system (the minimum 
of 7 is for the system RMD) 


list is the number of lines per page for the list 
output (LO) device, with typical values of 44 
for line printer and 61 for Teletype 


kpun is 26 for 026 keypunch (Hollerith code), or 
29 for 029 keypunch 


map is L if map information is to be listed, or 0 
if it is to be suppressed 


analysis is 0 or blank if a complete bad-track analysis 
is desired on all RMDs, or 1 if the bad-track tables 
from the last SGEN are to be used. If this 
parameter is omitted, a full analysis is performed. 
A value of 1 may be entered only when an 
analysis has been made on a previous SGEN, 


When analysis is specified, SGEN will bypass any 70-7500 or 
-7510 RMDs, the Bad Track Table written by the formatter is 
accepted for these and analysis will be performed on all 
other RMDs. 


Analysis for bad tracks in RMD partitioning is performed 
following the input of the EDR directive. When that process 
is complete, the nucleus or resident-task processor is 
loaded into main memory. 


Examples: Specify the redefinition of resident tasks only. 
EDR,R 


Specify full system generation with no empty TIDBs, no 
stack area, a maximum of seven partitions per RMD, 44 
lines per page on the list output, 026 keypunch, a list 
of the map, and no bad-track analysis. 


EDR,S,0,0,7,44,26,L 


varian data machines a 


Specify full system generation with 12 empty TIDBs, 0500 
addresses in the stack area, a maximum of 20 partitions per 
RMD, 30 lines per page on the list output, 029 keypunch mode, 
and suppression of the listing of a map. Assume the bad-track 
tables from the last SGEN are still good, and reuse them, 


EDR,S,12,0500,20,30,29,0,1 


5.5 PERFORMING SGEN 


This section describes the procedures for executing the job 
streams in the SGL. Section 5.5.1 is for SGLs on either 
Magnetic tape or cards. Section 5.5.2 describes the SGL 
from an RMD. 


5.5.1 SGL on Magnetic Tape or Cards 


The SGL is the first file of the SGL medium, Execution of 
the system generation programs is initiated by loading the 
appropriate system generation bootstrap. The choice of 

job streams depends upon the firmware options Floating-Point 
Processor (EPP) and Dataplot II use on the system. (VORTEX, 
VORTEX II, Section 18 for firmware description; VORTEX, 
Section 12 for Dataplot II). 


Basic OM Library Job Stream: The basic OM library job stream 
is the second and third files of the SGL medium. To execute 

this job stream, position to the second file and assign SI to 
the SGL medium. The basic job stream must always be executed 


in addition to one or more of the following depending upon 
satisfying the conditions in the following table: 
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Conditions 
Floating-point Floating-point File 

Accelerator? Firmware*? Processor (FPP)? Numbers 

No — No No. 4 and 5 

Yes No No 6 and 7 

No Yes No 4 and 5, 
12 and 13 

No No Yes 8 and 9 

Yes No Yes 10 and 11 


* 256-word (half page) WCS 


Other combinations of these options are not feasible. 


Dataplot II OM Library Job Streams: If Dataplot II is to be used, 
two additional job streams must be executed. One of these must 
always be the basic Dataplot II OM library job streams in files 

29 and 30. For VORTEX compatible Dataplot II, the job streams in 
files 31 and 32 are used in addition to the basic Dataplot II. For 
MOS compatible Dataplot II, the job streams in files 33 and 34 must 
be executed in addition to the basic Dataplot II. 


5.5.2 SGL on an RMD 


The SGL is located on the first partition of the SGL disc pack, 
The OM libraries in the second partition are in the form of object 
code (not job streams). Choice of the OM libraries to use depends 
upon the options on the system: floating-point processor, accelera- 
tor, floating-point firmware (256-word WCS), VTAM and Dataplot II. 
The files are used in the manner described for card and magnetic- 
tape SGLs. The procedures for executing the OM libraries from a 
disc pack SGL are described in the E Release Bulletin. 


5.6 SPOOL SUBSYSTEM FILE CREATION 
When the system is first activated after the complete SGEN 
procedure, OC will return I010 SPnn, where nn is the SPOOL 


name on the ASN directives. This message can be ignored and 
taken as an indication to create the files being requested. 


The procedure to create SPOOL files is as follows: 


5-18 


ae 
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From OC, key-in 


/FMAIN 
INIT ,SX,S 
CREATE, SX,S,SPOO0Ln,120,records 


where | 

n is the value from the SPnA specified on the EQP 
directive 

records is the number of 120-word logical records 
to be spooled (Section 5.4 gives more information 
on SPOOL file sizes) 


After all required SPOOL files have been created, 
i.e€., one for each SPnA EQP directive. 
From OC, key-in 


/FINI 


Boot the system in (Loaders sec. 5.2) and VORTEX with the 
SPOOL subsystem will be in operation. 
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SECTION 6 . 


SGL MAINTENANCE 


6.1 UPDATING SGL 


This section provides the user with the basic information 
needed to maintain a VORTEX or VORTEX II SGL. This 
information along with the SGL organization in Section 4 
will aid the user in modifying and copying the SGL. 


The VORTEX or VORTEX II SGL consists of several components. 

The first component is the collection of programs used to create 
the nucleus, and foreground and background libraries. In the 
following procedures, this component is referred to as the 
"system generator". The subsequent components consist of job 
streams to create various OM libraries and add modules for 
various application programs such as VTAM. In the following 
procedures, these components are referred to as the "system 

job streams". 


The system generator is an ordered set of ASCII Control 

records mixed with binary object records. As a result, 

the standard COPYF directive of IOUTIL cannot be used 

to copy this component. There are two ways that this component 
can be copied. First, the system program SMAIN is specifically 
designed for this purpose and must be used whenever any 
modifications are made to the system generator. Second, 

IOUTIL can be used to copy the system generator if the special 
record-length mode of the COPYF directive is used. To use 
COPYF, both input and output must specify a record length 

of zero and a read/write mode of ASCII. Further description 

is given in the following sections referring to the 

various SGL media. 


The system job streams are a collection of ASCII control and 
binary object records. These job streams may have several 
EOFs distributed throughout the job streams. Therefore, it 
is necessary that SGL organization information be carefully 
examined before any attempt is made to copy or modify these 
components. The system program SMAIN cannot effectively be 
used to copy or modify these components since it accepts only 
certain ASCII control records, must terminate with the 
specific control record, CTL,ENDOFSGL, will not accept any 
imbedded EOFS, and does a rewind at the beginning of any 
operation. Therefore, if a simple copy is all that is needed 
then IOUTIL should be used, but, if a deletion or replacement 
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is needed, then SMAIN should be used in the following manner: 


a. Separate the desired system job stream 
from the SGL medium by using IOUTIL 


b. Terminate the system job stream temporarily 
with the control record, CTL,ENDOFSGL 


cy Remove any imbedded EOFs from the job stream 
noting their position so that they may be 
restored later. 


d. Remove any ASCII control records from the 
job stream, they can be replaced with a 
valid control record such as ESB or END 
so that they can be reinserted 


e. Use SMAIN to add, delete, or replace the 
desired object modules 


f. Restore the job stream to its original state 
by replacing the proper control records 
and EOFs 


Because this procedure is involved and error prone, it is 
suggested that the usér does not attempt to modify SGL 
system job streams but rather creates subsequent job 

streams of his own that make use of FMAIN and LMGEN features 
to modify libraries created by the system job streams, 


Where a simple copy is all that is needed, then IOUTIL may be 
used in the same manner for the system generator (with zero 
record length and ASCII mode). 


6.2 COPYING SGL NOT USING AN RMD 


To copy SGL from a device other than an RMD to another 
non-RMD, the system program IOUTIL may be used. SMAIN 
should be used to copy the system generator part and 

IOUTIL to copy the system job streams. The system generator 
portion is separated from system job stream portion by an 
FOF, Therefore, upon completion of SMAIN an EOF should be 
written to the output and an EOF skipped on the input before 
continuing with the system job stream portion. Care should 
be taken to note the number of EOFs involved and that the 
SGL medium terminate with a double EOF. 
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6.3 COPYING TO AN RMD FROM ANOTHER TYPE OF DEVICE 


To copy from another form of SGL to an RMD is an involved 
process which requires special partitioning of the RMD 

and the creation of special files on that medium. The 
following procedure is provided to aid the user in creating 
an RMI) SGL from a non-RMD SGL. It is not intended to he 
used when the RMD serves only as a temporarv storage for a 
modified SGL. The RMD which is the destination must not 
contain the VORTEX or VORTEX II System. The procedure 

is as follows: 


a. Partition the RMD as described in the SGL 
organization for RMD, (section 4.1), either 
at system generation time or hv using the 
system program RAZI. 


b. Copy the system generation portion to the first 
partition of the RMD. This partition does not need 
a file name. It must contain at least 3000 sectors, 
because SMAIN does not pack SGL records. 


Ce Execute the job streams and note the number and 
positions of the control records. Then, use IOUTIL 
to skip over these control records, so that the 
SGL medium is positioned to the hinary object 
modules. System joh streams cannot be merely 
copied to the RMD but must have their ASCII control 
records separate from their ohject modules. 


d. Create files using FMAIN on the various partitions 
which are large enough to contain the binarv obiect 
modules. Refer to the SGL organization information 
in section 4, for the suggested sizes and partitions 
to be used. 

NOTE: The hinarvyv ohject modules will he packed 

as two 60-word records per sector on the RMN, but 
each object module must begin on a sector boundarv 
so the size of the file must be slightly greater 
than half the number of object records on the 
non-RM) medium. <A useful formula for this is 


records + modules 
where records is the number of 60-word records 
and modules is the number of object modules. 
e. Use the IOUTIL directive PACKB to copy the binarv 


object modules from the source to the selected 
file. <A PFILE directive must be used to open the 
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file. A CFILE with update directives must be 
used to close the file upon completion. The 
PACKB directive automatically handles the rules 
for object module packing. The input record 
length should be 60 words and the output record 
length, 120 words. The read/write mode should be 
system binary. | 


t. Repeat steps d and e for each desired system job 
stream. 


ge Modify the system job stream directives which were 
skipped over, to use the new input medium. Refer 
to the various system program descriptions in the 
Reference Manual (VORTEX, VORTEX II). Generally, 
it may be necessary to add a protection key and 
a file name, and, possibly, a PFILE directive. 
Note: PFILE can only be used for a global logical 
unit. 


ch. Copy the modified directives onto the SGL medium 
using IOUTIL, (or keep the directives separate 
from the SGL medium). Copy the directives into a 
file named SI, which is unpacked ASCII and has a 
record length of 40 words. There can be only one 


file named SI on each partition. Remove any imbedded 


FINI directives. 


This procedure is not simple. The description here assumes 
that the user is quite familiar with the components of the 
SGL and how they function. If any portion of the system job 
stream procedures appears to be beyond the capability of 

the user, it is suggested that system job stream portion of 
this procedure not be attempted. In this case the user can 
use SMAIN to create a disc SGL which contains only the system 
generator, and can continue to use the system job stream from 
another medium for those functions. 
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SECTION 7 
TROUBLESHOOTING 


This section provides descriptions of useful troubleshooting 
techniques: 


Trapping through SGEN 
Trapping through System Boot 
General VORTEX Troubleshooting aids 


(The Error Messages section in VORTEX and VORTEX II gives the 
meanings and solutions for common error messages) 


7.1 TRAPPING THROUGH SGEN 


To locate the SGEN Driver For Any Peripheral: Memory location 
0600 is the start of the physica unit table (PUT). This table 
has a two-word entry for each peripheral. The first word 

contains the device address in bits 0-5. The second word contains 
the DST address associated with the device. The DST address 

plus 7 (base 0) points to the STATUS routine in the driver for 

the device. The STATUS routine usually begins at the first 
location of the driver, 


To locate the driver, find the device address in the PUT for the 
desired peripheral. In the case of master/slave units, several 
device addresses for the desired peripheral will be in the PUT. 
Any one of these entry can be used. The second word of the 
entry contains the DST address. This address plus 7 is the 
address containing the driver address, 


Trapping through SGEN: The following procedure may be used 
or trapping through SGEN: 


ae Load the appropriate SGEN key-in but do not 
execute (i.e. LO with AID II 


b. Change the key-in location containing 01106 
(location 2 or 3) to the address of AID II 
(i.e. x6000 where x=3, 4, 5, 6, or 7) 


cs Execute the modified key-in (i.e. GO). Machine 
will go to AID II 


d. At this point SGENIO has been loaded. Set a trap 
at the location in SGENIO which contains the 
instruction JMP $XEQ (just prior to label LDP10). 
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Note: SGENIO is an absolute program. Now 
execute SGENIO (i.e., Txxxxxx, 1106, where 
Xxxxxx is the above address.) 


IO Interrogation will be conducted now. Upon 
completion of the interrogation the SGEN drivers 
will be loaded and the machine will execute the 
trap at xxxxxx (see step d). 


Set a halt in SGENLD at the location which 

contains the instruction JMP 0 (just prior 

to label $XEQ) and continue from the last trap 
point. (i.e., Gxxxxxx. where xxxxxx is last 

trap address). Note: SGENLD loads down from 

the top of main memory (less AID II and BLD II; for 
32K, it loads down from 075777) 


When the halt is executed, the SGEN module will 
be loaded. (The modules are loaded sequentially, 
i.e. SGEN1, SGEN2, SGEN3, and SGEN4). All SGEN 
modules load at location 03000. Each module 
handles a part of SGEN as follows: 


SGEN1 - directive processor 
SGEN2 - nucleus processor 

SGEN3 - library processor 

SGEN4 - resident task processor 


Manually go to AID II at this point. Each SGEN 
module starts at location 03000, 


At this point the SGEN module has not executed. 
If the particular SGEN module is to be debugged 
then the appropriate traps can be made. If 

the module is to run normally or its debugging 
is complete, then enter one of the following: 


1. G xxxxxx, where xxxxxx is the last trap 
address or 03000 if no module 
traps were made, 


oe C zzzzzz to 01000, where zzzzzz is the address 
set to halt in step f, then do 
step h (1). 


G xxxxxx is used to load the next SGEN 
component. This returns to step 
g of above. Czzzzzz causes SGEN 
to continue normally until completion. 
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7.2 TRAPPING THROUGH THE SYSTEM BOOT 


The following procedure may be used for trapping through the 
system boot and initializer. This procedure is useful in 
making patches to the nucleus, 


a. Load the appropriate system boot, but do not 
execute (i.e. LO with AID II). 


b. Change the boot location containing 0600 to the 
address of AID II. 


Ce Execute the modified boot (i.e. G1130). Machine 
will go to AID II. 


d. At this point the system initializer has been 
loaded but has not executed. (Initializers 
have a name in the form I$Da where a is the 
model code for the sytem RMD) . The initial- 
izer loads starting at memory location 0600. 


e. To load the nucleus but not activate the clock 
and PIMs, a trap should be set at the location 
of the label V$SCV in the appropriate initial- 
izer and execution continued at the start of the 
initializer. (i.e. Txxxxxx,600 where xxxxxx is 
the above label address). 


Le At this point the nucleus is loaded but VORTEX 
has not been activated. Patches may be made to 
the nucleus at this time. 


Ze To activate VORTEX enter Gxxxxxx where xxxxxx 
is the address from step e. 


7.3 TIPS FOR SYSTEM DEBUGGING 


The interrupt jump locations (0100-0277) for the PIM lines 
provide a good patch area, The locations for PIMs not in 
the system can be used and will not be destroyed 

except by rebooting the sytem, 


At times it is useful to do steps a through f (in 7.2) and 

then to use AID II to dump memory to magnetic tape, then 

perform step g. Doing this allows a copy of the patch nucleus 

to be saved. The tape can then be read into main memory and step 
g performed directly. 
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AID) II traps can only be performed in areas where the clock 
and PIMs are disabled after VORTEX is activated. In order 

to continue to use AID II for debugging the following patches 
can be made. These cause the PIMs and clocks to be disabled 
upon reaching a trap location. 


a. Change locations 0X6545 and 0X6546 to 01000 
and 222222. 


Where X = memory size, (i.e. X=7 for 32K, 
6 for 28K, etc.) and zz2zzzz, the starting 
address of a four-word block in scratch area 


of memory. (see note 1 of above) 


b. Change zzzzzz from above to 0100747, 0100444, 
01000, OX6505 where X is as above. 


1, These patches should be made at step f of the 
nucleus trap procedure and then step g can be 
replaced hy using the trap command. 


as This change alters two locations in AT) and 
thus these must he restored or AID reloaded 
after rebooting or when attempting to use 
AID without VORTEX. 


7.4 DEBUGGING AIDS 


The DEBUG program is resident on the OM library and can be 
cataloged with any task when debugging capabilities are 
required, (VORTEX, VORTEX II, 6.2.1, for cataloging with 
other tasks; VORTEX, VORTEX II, Section 7 for description 
of DEBUG use). 


When DEBUG is appended to a task which has no overlays, it 
is the last ohject module loaded. When the task has overlavs, 
DEBUG will be the last object module of the root segment. 


DEBUG can be copied to another library as a load module, with 
the following procedure: 


Under LMGEN enter: 


TIDB, DEBUG, type,0, DEBUG type=1, 2, or 3 

LN,SI 

(end-of-file, multipunched 2-7-8-9 or CONTROL-G, if SI 
is a keyboard device) | 

LIB 

END, lun, key 
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To catalog on SW only, delete lun,key 


The task will execute at level 0 upon entering /EXFC. 


Under VORTEX, DEBUG in the foreground may access all memory, 
and in the background, may access only background memory. 


Under VORTEX II, DEBUG in either foreground or hackground mav 


access only the memory within its memory map. 


NOTE: <A trap cannot be set within a memorv area which has 
the clock or PIMs disabled. 


7.5 DEBUGGING FORTRAN PROGRAMS 


Debugging VORTEX or VORTEX II FORTRAN programs is best done 

in source language, in segments, by checking out one module at 
a time, in the order in which they are executed. Source 
language debugging can usually locate a problem, or at least 
localize it so that the ohject language debugging can be 
minimized. 


The FORTRAN source language features most useful in debugging 
are the WRITE, READ and PAUSE statements. Additional 
statements of these tvnes can he added, and then deleted when 
debugging is completed. Test parameters can be entered with 
the READ statement and intermediate values output with the 
WRITE statement. The PAUSE statement is useful in detecting 
synchronization problems; for example, bv putting a WRITE 
statement in a suhprosram and a PAUSE statement in the main 
program, to examine the listing output by the WPITE statement 
after the PAUSE has heen executed, then verifv that the 
subprogram has been called the right number of times with 

the right input parameters and produced the right output 
parameters. 


If the source lanpuape debugsing does not locate the problen, 
object language dehugping is available through the DEBUG 
program (VORTEX, VORTEX II, Section 7) or the Dump option 

of the JCP /EXEC directive (VORTEX, VORTEX II 4.2.22). These 
produce absolute octal information and are used with three 
listings: 


ccnp OR A ROE SAE TS sh Es SS Pr ss PS Sr hn ASA RS SAS = sn A RA NNR a 


ae 


b. 
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SGEN map lists the absolute location of all nucleus 
arsTnat labels. 


LMGEN map lists the location (absolute for all 
VORTEX rt programs and for VORTEX background 
programs) of all external labels in or referenced 
by the module being tested, The main program 
should be given a name with the NAME directive, 
so that its location will be listed. 


FORTRAN compile-time source listing and map give 
the relative locations of all variables, arrays, 
constants and statement labels. Program locations 
are given relative to the first executable state- 
ment (see figure 7-1). Sizes of the program 


module and all COMMON modules are listed. 


Figure 7-1. FORTRAN Main Memory Load Module 


NOTES : 


(First instruction is always an ys 
unconditional jump forward over the 
program data block) 

Program Data Block (all non-common 
arrays, all variables which appear in 
EQUIVALENCE or DATA statements) 


Main Program Executable Code 3 
Main Program Postprogram Data Block 


(all variables and constants which do 
not appear in the program Data Block) 


4 


Ts Beginning of module (01000) for all VORTEX ITI 
modules, and VORTEX background modules 


Zs First executable instruction. If program is 
assigned a name by the NAME directive, its location| 
is here 


3. Program size, which will appear on compile-time 
source listing 


4, This location will be given the label $PEN on | 
LMGEN map 


varian data machines @- 


SECTION 8 
VORTEX SYSTEM MAINTENANCE 


VORTEX is subject to constant evaluation by the customer and 
in-house programming and operations personnel. As the need 
arises, new programs are added or existing ones modified. 

At the present time, VORTEX undergoes an interim revision 

every six months, with a major revision at alternating quarters. 


The interim revision is indicated by a decimal number following | 
the revision letter, as in C.1. These are incremental editings | 
to the VORTEX source of that change letter, so the source is 
not available. However, the edit listings are included so the 
user may update his existing source. 


The major revision is indicated bv a new revision letter, In 
a major revision a new source is created to include all modi- 
fications to date. 


| 
i 
The current release bulletin accompanies each VORTEX shipment. 
This bulletin defines the programs which have been changed, 
the number of the SMR (if applicable) which caused the change 
(SMR policy, section 10), and what changes were actually made. 
It also defines the SGL format and its file usage. | 
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SECTION 9 
SOFTWARE MAINTENANCE REQUESTS 


The Software Maintenance Request form provides a means of formally 
documenting a reported software malfunction. The purpose of the 
form and the maintenance procedure is to provide a controlled 

way of correcting errors which mav exist in our software. This 
procedure is specifically not applicable to requests for software 
modification, additions of features, etc. The latter requests 

are properly the subject of a Special Engineering Request. 

A failure to perform according to its written VDM specifica- 

tions and descriptions is the basis upon which the software 
maintenance is performed, 


The success of this software maintenance procedure is directly 
dependent upon the quality of the inputs. The following 
guidelines pertain to the Software Maintenance Request. 


a. Fill out only the side headed SOFTWARE MAINTENANCE | 
REQUEST. 


b. Do not fill in the lines DATE and LOG NO. 


C. Complete the entries in the block headed CUSTOMER | 
as completely as possible in order to limit the | 
number of communication channels to one, namely 
between Software Support and the source of the 
request. \ 


d. Complete the entries in the block headed VDM with 
the requested information. 


e. Complete the entries in the block headed PROGRAM, 
These are absolutely necessarv for software | 
support to know the exact software which has the 
alleged problem. 


fs Complete the entries in the block headed HARDWARE 
CONFIGURATION. The exact configuration on which 
the software was executed aids in efficient analysis 
of the problem, | 


Ze Nescrihe the problem in the block headed SYMPTOMS / | 
DESCRIPTION OF PROBLEM, 
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h. Supply diagnostic information and indicate the type 
supplied in the block headed DIAGNOSTIC EXHIBITS 
SUPPLIED. 


i. The person who fills in the form should enter 
his name on the line titled AUTHOR. The author 
should be the individual who encountered the problem. 


The cognizant VDM salesman or field application engineer should 
provide guidance and assistance to provide the useful pertinent 
information. 


When the form arrives in the APPLICATIONS ENGINFERING group, the 
form is screened by Software Support personnel. Those requests 
containing sufficient information to act upon are forwarded to 
the Systems Programming group where the problem is analyzed and 
resolved. Requests which do not contain sufficient information 
are returned to the submitter. 


SOFTWARE MAINTENANCE REQUEST 
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APPLICATIONS ENGINEERING 
2722 MICHELSON DRIVE LOG NO. 


IRVINE, CALIFORNIA 92664 


CUSTOMER 


NAME SALES OFFICE 
ADDRESS SALESMAN 
LOCATION APPL. ENGR, 
PHONE 


SALES ORDER 
NUMBER 


CONTACT 


PROGRAM 


NAME 
MDI PART: INO VV ERST ON REVISION 


HARDWARE CONFIGURATION 
CT) 620/__ , so. E}.wes 


MEMORY SIZE . 
Ow _ CUD core OC) sc a 

MEMORY SIZE (1) MEMORY WRAP-AROUND 
CV a 
Cl pma/stc__—“—*ts—s—s—s—s—s—sOSOSO—C—CTTCCC—C—C“(‘CS~™~™CCCCC)V PERIPHERAL) 


Oem CO tr 


SYMPTOMS/DESCRIPTION OF PROBLEM 


DIAGNOSTIC EXHIBITS SUPPLIED: 
CO) memory bump (0 output ListiING (CD user source LIsTING 
(J User SOURCE TAPE (CO user OBJECT TAPE 


AUTHOR 
96A0060-000C 


